---
title: Jira
description: 与 Jira 互动
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="jira"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Jira](https://www.atlassian.com/jira) 是一个领先的项目管理和问题跟踪平台，帮助团队有效地规划、跟踪和管理敏捷软件开发项目。作为 Atlassian 套件的一部分，Jira 已成为全球软件开发团队和项目管理专业人士的行业标准。

Jira 提供了一套全面的工具，通过其灵活且可定制的工作流系统来管理复杂项目。凭借其强大的 API 和集成能力，Jira 使团队能够简化开发流程，并保持对项目进度的清晰可见性。

Jira 的主要功能包括：

- 敏捷项目管理：支持 Scrum 和 Kanban 方法论，提供可定制的看板和工作流
- 问题跟踪：复杂的跟踪系统，用于管理缺陷、用户故事、史诗和任务，并提供详细报告
- 工作流自动化：强大的自动化规则，用于简化重复性任务和流程
- 高级搜索：JQL（Jira 查询语言）支持复杂问题过滤和报告

在 Sim 中，Jira 集成允许您的代理无缝地与您的项目管理工作流互动。这为自动化问题创建、更新和跟踪提供了可能性，作为您的 AI 工作流的一部分。该集成使代理能够以编程方式创建、检索和更新 Jira 问题，从而促进自动化项目管理任务，确保重要信息得到妥善跟踪和记录。通过将 Sim 与 Jira 连接，您可以构建智能代理，在自动化日常项目管理任务的同时保持项目的可见性，提高团队生产力，并确保一致的项目跟踪。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Jira 集成到工作流程中。可以读取、写入和更新问题。还可以基于 Jira 的 webhook 事件触发工作流程。

## 工具

### `jira_retrieve`

检索特定 Jira 问题的详细信息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `projectId` | 字符串 | 否 | Jira 项目 ID \(可选；检索单个问题时不需要\)。 |
| `issueKey` | 字符串 | 是 | 要检索的 Jira 问题键 \(例如：PROJ-123\) |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 包含问题键、摘要、描述、创建和更新时间戳的 Jira 问题详细信息 |

### `jira_update`

更新 Jira 问题

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `projectId` | 字符串 | 否 | 要更新问题的 Jira 项目 ID。如果未提供，将检索所有问题。 |
| `issueKey` | 字符串 | 是 | 要更新的 Jira 问题键 |
| `summary` | 字符串 | 否 | 问题的新摘要 |
| `description` | 字符串 | 否 | 问题的新描述 |
| `status` | 字符串 | 否 | 问题的新状态 |
| `priority` | 字符串 | 否 | 问题的新优先级 |
| `assignee` | 字符串 | 否 | 问题的新负责人 |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 更新的 Jira 问题详情，包括时间戳、问题键、摘要和成功状态 |

### `jira_write`

编写一个 Jira 问题

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `projectId` | 字符串 | 是 | 问题的项目 ID |
| `summary` | 字符串 | 是 | 问题的摘要 |
| `description` | 字符串 | 否 | 问题的描述 |
| `priority` | 字符串 | 否 | 问题的优先级 |
| `assignee` | 字符串 | 否 | 问题的负责人 |
| `cloudId` | 字符串 | 否 | 实例的 Jira 云 ID。如果未提供，将使用域名获取。 |
| `issueType` | 字符串 | 是 | 要创建的问题类型 \(例如：任务、故事\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 创建的 Jira 问题详情，包括时间戳、问题键、摘要、成功状态和 URL |

### `jira_bulk_read`

批量检索多个 Jira 问题

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `projectId` | 字符串 | 是 | Jira 项目 ID |
| `cloudId` | 字符串 | 否 | Jira 云 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | array | 包含 Jira 问题的数组，包括摘要、描述、创建和更新的时间戳 |

### `jira_delete_issue`

删除 Jira 问题

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要删除的 Jira 问题键 \(例如：PROJ-123\) |
| `deleteSubtasks` | 布尔值 | 否 | 是否删除子任务。如果为 false，则无法删除具有子任务的父问题。 |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 删除的问题详情，包括时间戳、问题键和成功状态 |

### `jira_assign_issue`

将 Jira 问题分配给用户

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要分配的 Jira 问题键 \(例如：PROJ-123\) |
| `accountId` | 字符串 | 是 | 要分配问题的用户的账户 ID。使用 "-1" 进行自动分配，或使用 null 取消分配。 |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 分配详情，包括时间戳、问题键、分配人 ID 和成功状态 |

### `jira_transition_issue`

在工作流状态之间移动 Jira 问题（例如，从“待办”到“进行中”）

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要转换的 Jira 问题键 \(例如：PROJ-123\) |
| `transitionId` | 字符串 | 是 | 要执行的转换 ID \(例如：“11”表示“待办”，“21”表示“进行中”\) |
| `comment` | 字符串 | 否 | 转换问题时添加的可选评论 |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 转换详情，包括时间戳、问题键、转换 ID 和成功状态 |

### `jira_search_issues`

使用 JQL（Jira 查询语言）搜索 Jira 问题

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `jql` | 字符串 | 是 | 用于搜索问题的 JQL 查询字符串 \(例如：“project = PROJ AND status = Open”\) |
| `startAt` | 数字 | 否 | 要返回的第一个结果的索引 \(用于分页\) |
| `maxResults` | 数字 | 否 | 要返回的最大结果数 \(默认值：50\) |
| `fields` | 数组 | 否 | 要返回的字段名称数组 \(默认值：\['summary', 'status', 'assignee', 'created', 'updated'\]\) |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 搜索结果，包括时间戳、总数、分页详情和匹配问题的数组 |

### `jira_add_comment`

向 Jira 问题添加评论

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要添加评论的 Jira 问题键 \(例如：PROJ-123\) |
| `body` | 字符串 | 是 | 评论正文文本 |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 评论详情，包括时间戳、问题键、评论 ID、正文和成功状态 |

### `jira_get_comments`

获取 Jira 问题的所有评论

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要获取评论的 Jira 问题键 \(例如：PROJ-123\) |
| `startAt` | 数字 | 否 | 要返回的第一条评论的索引 \(默认值：0\) |
| `maxResults` | 数字 | 否 | 要返回的评论的最大数量 \(默认值：50\) |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 评论数据，包括时间戳、问题键、总数和评论数组 |

### `jira_update_comment`

更新 Jira 问题上的现有评论

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 包含评论的 Jira 问题键 \(例如：PROJ-123\) |
| `commentId` | 字符串 | 是 | 要更新的评论 ID |
| `body` | 字符串 | 是 | 更新后的评论文本 |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 更新的评论详情，包括时间戳、问题键、评论 ID、正文文本和成功状态 |

### `jira_delete_comment`

从 Jira 问题中删除评论

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 包含评论的 Jira 问题键 \(例如：PROJ-123\) |
| `commentId` | 字符串 | 是 | 要删除的评论 ID |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 删除详情，包括时间戳、问题键、评论 ID 和成功状态 |

### `jira_get_attachments`

从 Jira 问题中获取所有附件

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要获取附件的 Jira 问题键 \(例如：PROJ-123\) |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 附件数据，包括时间戳、问题键和附件数组 |

### `jira_delete_attachment`

从 Jira 问题中删除附件

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `attachmentId` | 字符串 | 是 | 要删除的附件 ID |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 删除详情，包括时间戳、附件 ID 和成功状态 |

### `jira_add_worklog`

向 Jira 问题添加时间跟踪工作日志条目

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要添加工作日志的 Jira 问题键 \(例如：PROJ-123\) |
| `timeSpentSeconds` | 数字 | 是 | 花费的时间（以秒为单位） |
| `comment` | 字符串 | 否 | 工作日志条目的可选评论 |
| `started` | 字符串 | 否 | 可选的 ISO 格式开始时间 \(默认为当前时间\) |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 工作日志详情，包括时间戳、问题键、工作日志 ID、花费的时间（以秒为单位）和成功状态 |

### `jira_get_worklogs`

从 Jira 问题中获取所有工作日志条目

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要获取工作日志的 Jira 问题键 \(例如：PROJ-123\) |
| `startAt` | 数字 | 否 | 要返回的第一个工作日志的索引 \(默认值：0\) |
| `maxResults` | 数字 | 否 | 要返回的最大工作日志数 \(默认值：50\) |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 包含时间戳、问题键、总数和工作日志数组的工作日志数据 |

### `jira_update_worklog`

更新 Jira 问题上的现有工作日志条目

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 包含工作日志的 Jira 问题键 \(例如：PROJ-123\) |
| `worklogId` | 字符串 | 是 | 要更新的工作日志条目的 ID |
| `timeSpentSeconds` | 数字 | 否 | 花费的时间（以秒为单位） |
| `comment` | 字符串 | 否 | 工作日志条目的可选评论 |
| `started` | 字符串 | 否 | ISO 格式的可选开始时间 |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 包含时间戳、问题键、工作日志 ID 和成功状态的工作日志更新详情 |

### `jira_delete_worklog`

从 Jira 问题中删除工作日志条目

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 包含工作日志的 Jira 问题键 \(例如：PROJ-123\) |
| `worklogId` | 字符串 | 是 | 要删除的工作日志条目的 ID |
| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 删除详情，包括时间戳、问题键、工作日志 ID 和成功状态 |

### `jira_create_issue_link`

在两个 Jira 问题之间创建链接关系

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `inwardIssueKey` | 字符串 | 是 | 内部问题的 Jira 问题键 \(例如：PROJ-123\) |
| `outwardIssueKey` | 字符串 | 是 | 外部问题的 Jira 问题键 \(例如：PROJ-456\) |
| `linkType` | 字符串 | 是 | 链接关系的类型 \(例如：“阻止”、“关联到”、“重复”\) |
| `comment` | 字符串 | 否 | 可选评论，添加到问题链接中 |
| `cloudId` | 字符串 | 否 | 实例的 Jira 云 ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 问题链接详情，包括时间戳、内部问题键、外部问题键、链接类型和成功状态 |

### `jira_delete_issue_link`

删除两个 Jira 问题之间的链接

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `linkId` | 字符串 | 是 | 要删除的问题链接的 ID |
| `cloudId` | 字符串 | 否 | 实例的 Jira 云 ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 删除详情，包括时间戳、链接 ID 和成功状态 |

### `jira_add_watcher`

为 Jira 问题添加观察者以接收更新通知

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要添加观察者的 Jira 问题键 \(例如：PROJ-123\) |
| `accountId` | 字符串 | 是 | 要添加为观察者的用户账户 ID |
| `cloudId` | 字符串 | 否 | 实例的 Jira 云 ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 观察者详情，包括时间戳、问题键、观察者账户 ID 和成功状态 |

### `jira_remove_watcher`

从 Jira 问题中移除观察者

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) |
| `issueKey` | 字符串 | 是 | 要移除观察者的 Jira 问题键 \(例如：PROJ-123\) |
| `accountId` | 字符串 | 是 | 要移除的观察者用户账户 ID |
| `cloudId` | 字符串 | 否 | 实例的 Jira 云 ID。如果未提供，将使用域名获取。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 移除详情，包括时间戳、问题键、观察者账户 ID 和成功状态 |

## 注意事项

- 类别: `tools`
- 类型: `jira`
